home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 17 / CU Amiga Magazine's Super CD-ROM 17 (1997)(EMAP Images)(GB)[!][issue 1997-12].iso / CUCD / Programming / DiceSource / src / vmake / readme.vmake2-8 < prev    next >
Encoding:
Text File  |  1994-02-12  |  2.9 KB  |  70 lines
  1. Vmake version 2.8 adds command line handling and makes some changes to the
  2. format of the config file.
  3.  
  4. The template for VMake is "PROJECT,REXX/K,CONFIG/K,BUILD/S".  All parameters
  5. are optional.
  6.  
  7. PROJECT is just the name of the .dice file to be opened for the VMake session
  8. This parameter is not used if VMake failed to read a config file.
  9.  
  10. The REXX keyword is followed by the name of an AREXX script to be executed at
  11. startup.  The script will be executed after the config file has been
  12. processed and the project read in (if any).  There are two parameters, the
  13. name of the REXX port for this VMake window and the name of the project file,
  14. or null if VMake did not successfully open a project.  This parameter is not
  15. processed if VMake failed to read a config file.
  16.  
  17. The CONFIG keyword is followed by the name of a configuration (.config) file
  18. to use in place of the default, DCC:config/vmake.config.  If this parameter
  19. is present, it will be processed at startup before the project file is
  20. processed.
  21.  
  22. The BUILD switch is intended to build the entire project when VMake starts
  23. up.  In fact, it executes the string at CONFIG slot 9, so it can be made to
  24. do whatever you want at startup.  The command will not be executed if VMake
  25. failed to process the config or project file.
  26.  
  27. All of these commands can also be specified as tooltypes in a VMake project
  28. icon for use from the workbench.  The formats are as follows:
  29.  
  30. FILE=project.dice
  31.  
  32. Note that it is not necessary to specify this tooltype.  The default project
  33. is the name of the icon.  However, by using this paramenter you can provide 
  34. several icons with different tooltype commands that work on the same project
  35. file. 
  36.  
  37. REXX=script.rexx
  38.  
  39. CONFIG=path/to/alternate.config
  40.  
  41. BUILD
  42.  
  43. The ToolTypes are processed exactly the same as the corresponding command
  44. line options.
  45.  
  46.  
  47. The config file has been reorganized to use a new type of string, SUBRTN in
  48. addition to the TEXT and CONFIG strings.  
  49.  
  50. The TEXT strings include labels for some of the gadgets and for error
  51. requesters. 
  52.  
  53. The CONFIG strings include commands and strings that are used in a
  54. predefined way by VMake, such as slot 5 which contains the command that will
  55. be executed when you double click on a list entry.
  56.  
  57. The SUBRTN strings are user definable, and exist to make it easy to define
  58. actions for menu items and buttons.  There are twelve SUBRTN slots
  59. available.  Only the first four are defined in the standard config file
  60. provided with DICE.  (They were CONFIG slots 8 through 11 in the original
  61. DICE document and became slots 9 through 12 with VMake version 2.7)
  62.  
  63. The CALL command has been changed so that it now calls the SUBRTN slots
  64. instead of the CONFIG slots.  This means that future additions to the CONFIG
  65. table will not force extensive editing of all CALL commands in the config
  66. file.  It should make it easier for you to use project specific
  67. configuration files by reducing the impact of adding new features.
  68.  
  69. The config file for VMake version 2.8 has been revised to conform to these
  70. changes.